Main Page

<mediawiki xmlns="http://www.mediawiki.org/xml/export-0.11/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mediawiki.org/xml/export-0.11/ http://www.mediawiki.org/xml/export-0.11.xsd" version="0.11" xml:lang="en">
  <siteinfo>
    <sitename>OrcaWiki</sitename>
    <dbname>orca-mediawiki</dbname>
    <base>https://www.orcaware.com/orca/wiki/Main_Page</base>
    <generator>MediaWiki 1.42.4</generator>
    <case>first-letter</case>
    <namespaces>
      <namespace key="-2" case="first-letter">Media</namespace>
      <namespace key="-1" case="first-letter">Special</namespace>
      <namespace key="0" case="first-letter" />
      <namespace key="1" case="first-letter">Talk</namespace>
      <namespace key="2" case="first-letter">User</namespace>
      <namespace key="3" case="first-letter">User talk</namespace>
      <namespace key="4" case="first-letter">OrcaWiki</namespace>
      <namespace key="5" case="first-letter">OrcaWiki talk</namespace>
      <namespace key="6" case="first-letter">File</namespace>
      <namespace key="7" case="first-letter">File talk</namespace>
      <namespace key="8" case="first-letter">MediaWiki</namespace>
      <namespace key="9" case="first-letter">MediaWiki talk</namespace>
      <namespace key="10" case="first-letter">Template</namespace>
      <namespace key="11" case="first-letter">Template talk</namespace>
      <namespace key="12" case="first-letter">Help</namespace>
      <namespace key="13" case="first-letter">Help talk</namespace>
      <namespace key="14" case="first-letter">Category</namespace>
      <namespace key="15" case="first-letter">Category talk</namespace>
    </namespaces>
  </siteinfo>
<page arvcontinue="">
  <title>Main Page</title>
  <ns>0</ns>
  <id>1</id>
  <revision>
    <id>1</id>
    <timestamp>2006-06-22T05:56:43Z</timestamp>
    <contributor>
      <username>MediaWiki default</username>
      <id>0</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="455" xml:space="preserve">&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

== Getting started ==

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>cfe9e457290978db5c59f7ed0e6495177716a20e</sha1>
  </revision>
  <revision>
    <id>1531</id>
    <parentid>1</parentid>
    <timestamp>2006-10-25T23:08:41Z</timestamp>
    <contributor>
      <username>Devaultd</username>
      <id>3</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1593" xml:space="preserve">== ORCA Documentation ==

''Orca is a tool useful for plotting arbitrary data from text files onto a directory on a Web server.''&lt;br&gt;
''Written and Maintained by Blair Zajac and the Open Source Communitiy''


=== Table of Contents ===
====[[Introduction]]====
*Get the latest source
* Requirements for proper statistic gathering
** Dependencies on other apps 
*Installation, configuration &amp; compilling the source
**Solaris
**Linux
**Other Unix systems
**Windows Platforms

* Tips &amp; Tricks
* Procedures 
* Headaches 
* Work-a-rounds for problems 

==== Customization ====
* Custom changes for specific configurations
**orcallator
**procallator

* Cron entries 
* Additional Logging 
* Example cron entries 
* Example scripts (any scripts created to use procallator) 
* Example rc scripts 

==== Production ====
* Performance info 
* Monitoring 
* Environment Layouts 
** One Orca statistic parser process server -&gt; many orca statistic gathering servers
** Orca parser process server &amp; statistic gathering on the same server
** Seperate systems used for parsing, storing, presenting the gathered / processed data


== Wiki Info ==


&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

==== Getting started ====

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>8f0a5658cbe56051cd66dbefedf163a45267ccb0</sha1>
  </revision>
  <revision>
    <id>1532</id>
    <parentid>1531</parentid>
    <timestamp>2006-11-01T23:52:44Z</timestamp>
    <contributor>
      <username>Devaultd</username>
      <id>3</id>
    </contributor>
    <comment>/* ORCA Documentation */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1627" xml:space="preserve">== ORCA Documentation ==

''Orca is a tool useful for plotting arbitrary data from text files onto a directory on a Web server.''&lt;br&gt;
''Written and Maintained by Blair Zajac and the Open Source Communitiy''


=== Table of Contents ===
====[[Introduction]]====
* Get the latest source
* Requirements for proper statistic gathering
** Dependencies on other apps 
* Installation, configuration &amp; compilling the source
**Solaris
**Linux
**Other Unix systems
**Windows Platforms

* Tips &amp; Tricks
* Procedures 
* Headaches 
* Work-a-rounds for problems
* FAQ - Frequently Asked Questions 

==== Customization ====
* Custom changes for specific configurations
**orcallator
**procallator

* Cron entries 
* Additional Logging 
* Example cron entries 
* Example scripts (any scripts created to use procallator) 
* Example rc scripts 

==== Production ====
* Performance info 
* Monitoring 
* Environment Layouts 
** One Orca statistic parser process server -&gt; many orca statistic gathering servers
** Orca parser process server &amp; statistic gathering on the same server
** Seperate systems used for parsing, storing, presenting the gathered / processed data

== Wiki Info ==


&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

==== Getting started ====

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>52212b3b237945fdd48d5b1db9d2c5734ffaa9dc</sha1>
  </revision>
  <revision>
    <id>1533</id>
    <parentid>1532</parentid>
    <timestamp>2006-11-01T23:53:32Z</timestamp>
    <contributor>
      <username>Devaultd</username>
      <id>3</id>
    </contributor>
    <comment>/* ORCA Documentation */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1631" xml:space="preserve">== ORCA Documentation ==

''Orca is a tool useful for plotting arbitrary data from text files onto a directory on a Web server.''&lt;br&gt;
''Written and Maintained by Blair Zajac and the Open Source Communitiy''


=== Table of Contents ===
====[[Introduction]]====
* Get the latest source
* Requirements for proper statistic gathering
** Dependencies on other apps 
* Installation, configuration &amp; compilling the source
**Solaris
**Linux
**Other Unix systems
**Windows Platforms

* Tips &amp; Tricks
* Procedures 
* Headaches 
* Work-a-rounds for problems
* FAQ - Frequently Asked Questions 

====[[Customization]]====
* Custom changes for specific configurations
**orcallator
**procallator

* Cron entries 
* Additional Logging 
* Example cron entries 
* Example scripts (any scripts created to use procallator) 
* Example rc scripts 

====[[Production]]====
* Performance info 
* Monitoring 
* Environment Layouts 
** One Orca statistic parser process server -&gt; many orca statistic gathering servers
** Orca parser process server &amp; statistic gathering on the same server
** Seperate systems used for parsing, storing, presenting the gathered / processed data

== Wiki Info ==


&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

==== Getting started ====

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>063d62e384449942032135184ac3552b07e4e94c</sha1>
  </revision>
  <revision>
    <id>1535</id>
    <parentid>1533</parentid>
    <timestamp>2006-11-08T21:34:46Z</timestamp>
    <contributor>
      <username>Cnk</username>
      <id>5</id>
    </contributor>
    <comment>/* [[Introduction]] */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1634" xml:space="preserve">== ORCA Documentation ==

''Orca is a tool useful for plotting arbitrary data from text files onto a directory on a Web server.''&lt;br&gt;
''Written and Maintained by Blair Zajac and the Open Source Communitiy''


=== Table of Contents ===
====[[Introduction]]====
* [[Get the latest source]]
* Requirements for proper statistic gathering
** Dependencies on other apps 
* Installation, configuration &amp; compilling the source
**Solaris
**Linux
**Other Unix systems
**Windows Platforms

* Tips &amp; Tricks
* Procedures 
* Headaches 
* Work-a-rounds for problems
* FAQ - Frequently Asked Questions

====[[Customization]]====
* Custom changes for specific configurations
**orcallator
**procallator

* Cron entries 
* Additional Logging 
* Example cron entries 
* Example scripts (any scripts created to use procallator) 
* Example rc scripts 

====[[Production]]====
* Performance info 
* Monitoring 
* Environment Layouts 
** One Orca statistic parser process server -&gt; many orca statistic gathering servers
** Orca parser process server &amp; statistic gathering on the same server
** Seperate systems used for parsing, storing, presenting the gathered / processed data

== Wiki Info ==


&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

==== Getting started ====

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>3622f98f3c4fdf160e1158b0faf47b20796fb93e</sha1>
  </revision>
  <revision>
    <id>1538</id>
    <parentid>1535</parentid>
    <timestamp>2008-05-22T16:21:47Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>/* [[Introduction]] */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1700" xml:space="preserve">== ORCA Documentation ==

''Orca is a tool useful for plotting arbitrary data from text files onto a directory on a Web server.''&lt;br&gt;
''Written and Maintained by Blair Zajac and the Open Source Communitiy''


=== Table of Contents ===
====[[Introduction]]====
* [[Get the latest source]]
* Requirements for proper statistic gathering
** Dependencies on other apps 
* Installation, configuration &amp; compilling the source
**Solaris[[http://www.orcaware.com/orca/wiki/Solaris10_installation_howto]]
**Linux
**Other Unix systems
**Windows Platforms

* Tips &amp; Tricks
* Procedures 
* Headaches 
* Work-a-rounds for problems
* FAQ - Frequently Asked Questions

====[[Customization]]====
* Custom changes for specific configurations
**orcallator
**procallator

* Cron entries 
* Additional Logging 
* Example cron entries 
* Example scripts (any scripts created to use procallator) 
* Example rc scripts 

====[[Production]]====
* Performance info 
* Monitoring 
* Environment Layouts 
** One Orca statistic parser process server -&gt; many orca statistic gathering servers
** Orca parser process server &amp; statistic gathering on the same server
** Seperate systems used for parsing, storing, presenting the gathered / processed data

== Wiki Info ==


&lt;big&gt;'''MediaWiki has been successfully installed.'''&lt;/big&gt;

Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for information on using the wiki software.

==== Getting started ====

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>0614bfeac51fbb776ffe841af7f8a10f9f02fa42</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Get the latest source</title>
  <ns>0</ns>
  <id>1467</id>
  <revision>
    <id>1534</id>
    <timestamp>2006-11-08T21:34:19Z</timestamp>
    <contributor>
      <username>Cnk</username>
      <id>5</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1273" xml:space="preserve">OrcaWare Technologies hosts all of its open-source and publicly available code in a public Subversion server.

Browse the OrcaWare source code repository to see the packages available for download. There are three different ways you can connect to the Subversion repository and download content. You can choose between:

    * HTML over port 80
    * XML over port 80

When checking out the source code on this server, please be extra careful to check out only the package you need, otherwise you may check out the entire repository and fill up a minimum of 300 Mbytes on your disk and take forever to check out. Here are some sample commands:

    * Check out the HEAD revision, that is the latest version, of the Orca package:
      $ svn co http://www.orcaware.com/svn/repos/orca/trunk/
    * Check out Orca tagged at version 0.27:
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/0.27/
    * These are the commands to avoid, as they will check out everything underneath the specified URL. Be careful :) :
      $ svn co http://www.orcaware.com/svn/repos/
      $ svn co http://www.orcaware.com/svn/repos/orca/
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/

Only the URLs for the HTML viewing also allow commits against the Subversion repository.</text>
    <sha1>4bfe3f6a8d92fbc1f13a07a266e7f622ebd4b5ea</sha1>
  </revision>
  <revision>
    <id>1536</id>
    <parentid>1534</parentid>
    <timestamp>2006-11-08T21:38:09Z</timestamp>
    <contributor>
      <username>Cnk</username>
      <id>5</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1150" xml:space="preserve">OrcaWare Technologies hosts all of its open-source and publicly available code in a public Subversion server.

Use your browser to browse the OrcaWare source code repository to see what packages are available for download.

    * Via HTML at http://www.orcaware.com/svn/repos/ 
    * Via XML at http://www.orcaware.com/svn/repos-xml/ 

When checking out the source code on this server, please be extra careful to check out only the package you need, otherwise you may check out the entire repository and fill up a minimum of 300 Mbytes on your disk and take forever to check out. Here are some sample commands:

    * Check out the HEAD revision, that is the latest version, of the Orca package:
      $ svn co http://www.orcaware.com/svn/repos/orca/trunk/
    * Check out Orca tagged at version 0.27:
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/0.27/
    * These are the commands to avoid, as they will check out everything underneath the specified URL. Be careful :) :
      $ svn co http://www.orcaware.com/svn/repos/
      $ svn co http://www.orcaware.com/svn/repos/orca/
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/</text>
    <sha1>b7ea25bcfd0ad56b604a52a70e525d2374cdda69</sha1>
  </revision>
  <revision>
    <id>1537</id>
    <parentid>1536</parentid>
    <timestamp>2006-11-08T21:44:02Z</timestamp>
    <contributor>
      <username>Cnk</username>
      <id>5</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1570" xml:space="preserve">OrcaWare Technologies hosts all of its open-source and publicly available code in a public Subversion server.

Use your browser to browse the OrcaWare source code repository to see what packages are available for download.

    * Via HTML at http://www.orcaware.com/svn/repos/ 
    * Via XML at http://www.orcaware.com/svn/repos-xml/ 

When checking out the source code on this server, please be extra careful to check out only the package you need, otherwise you may check out the entire repository and fill up a minimum of 300 Mbytes on your disk and take forever to check out. Here are some sample commands:

    * Check out the HEAD revision, that is the latest version, of the Orca package:
      $ svn co http://www.orcaware.com/svn/repos/orca/trunk/
    * Check out Orca tagged at version 0.27:
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/0.27/
    * These are the commands to avoid, as they will check out everything underneath the specified URL. Be careful :) :
      $ svn co http://www.orcaware.com/svn/repos/
      $ svn co http://www.orcaware.com/svn/repos/orca/
      $ svn co http://www.orcaware.com/svn/repos/orca/tags/

WARNING: The main OrcaWare site has a link to "Latest Stable", this is probably NOT what you want. For example, that code will not work for Solaris 10 and does not contain data gatherers for Linux 2.6 kernels. The latest subversion checkout is usually quite stable. 

If you don't use subversion or for some other reason would like a distribution tarball, you can get one at http://www.orcaware.com/orca/pub/snapshots/</text>
    <sha1>057df8d139a89f87639e20b5198f220add9fc7b3</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Solaris10 installation howto</title>
  <ns>0</ns>
  <id>1468</id>
  <revision>
    <id>1539</id>
    <timestamp>2008-05-22T16:26:47Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>New page: This "How To" is probably just one way to setup the server, but it works.  All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also...</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7908" xml:space="preserve">This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work)
1. make 3.80
2. gcc 3.4.6
3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc)
4. libiconv-1.11-sol10-sparc-local.gz
5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)
==============================================================
Ayotunde Itayemi (Last updated 22/05/2008)


Installing Apache2 on the Central Server
========================================
make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
You can get all the packages above from sunfreeware.com.


Installing ORCA on server and clients
==================================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)
   Not necessary: Install freetype2 package from sunfreeware

3. set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10)
Also the package SUNWsprot must be installed on the server - it is usually installed by default)
   ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
   http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse
(OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )


6. install Orca (or orcallator.se on clients)
extract the Orca compressed package e.g., to /opt
NOTE: it may be a good idea to install orcallator somewhere else apart
from the default /usr/local since its files will grow e.g., on a dedicated
filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xvf orca-snapshot-r535.tar

cd orca-snapshot-r535

=== Solaris 10 NOTE ==============================================

IN FILE: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

1. change the line "CCCDLFLAGS = -KPIC" to "CCCDLFLAGS ="
2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H

TO:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H


3. change the line "OPTIMIZE = -xO3 -xspace -xildoff" to "OPTIMIZE ="


IN FILE:  orca-snapshot-r535/packages/Storable-2.15/Makefile

1. change the line "CCCDLFLAGS = -KPIC" to "CCCDLFLAGS ="

2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO

TO:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO


3. change the line "OPTIMIZE = -xO3 -xspace -xildoff" to "OPTIMIZE ="


=== END OF Solaris 10 NOTE ==============================


# if you are reinstalling, remember to delete the existing orca folder or else
the new installation will not succeed e.g.,
bash-3.00# rm -rf /usr/local/var/orca

# make fails because the default perl expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# make fails because it couldn't locate perl pod2man executable, so find it and add to PATH
# variable
bash-3.00# find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin


bash-3.00# cd ..
bash-3.00# pwd
orca-0.27b3

bash-3.00#

./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

make; make install; make orcallator_run_at_boot


============ orca doesn't start on solaris 10 ============================

Because the following statement in the orcallator startup script is used
to derive part of the name of the PATH to some of the files needed by
orcalltor, orcallator does not start
"/opt/RICHPse/bin/se -version | awk '{print $4}'"
the reason is that the command above returns 3.4.1 which is the used to
generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
The actual path on the server is /usr/local/lib/SE/3.4
The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1

============ orca doesn't start on solaris 10 ============================


start the orcallator
/etc/init.d/orcallator start


mkdir -p /var/apache2/htdocs/orca/orcallator


DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl


The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

(once it starts up completely without errors and completes the first run,
kill the process (find it's pid with "ps -ef | grep orca")

then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d
for the above process.


edit the /etc/hosts on both the server and client and ensure they can "see" each other
(alternatively use DNS)


Configure the client for "password-less" login to the server
==============================================================
on the client (as root) run "ssh-keygen -t rsa" to generate the client's
authentication key files, when asked for the name of the file
in which to save the key, just press the ENTER key 
and when asked for a paraphrase also press the ENTER key.
Press ENTER key again to confirm the blank paraphrase. 
This generates the default pair of files 
/.ssh/id_rsa and /.ssh/id_rsa.pub

copy the content of the /.ssh/id_rsa.pub from the client into
the /.ssh/authorized_keys on the server.
(make the permission on the authorized_keys file 400 i.w., 
"chmod 400 authorized_keys")

NOTE: the content of the id_rsa.pub file is one single continuous line
NOTE: if there are other lines in the authorized_keys file on the server,
just place the content of the id_rsa.pub file on a new line.
NOTE: extablish a test connection from client to server (at least once)
      manually so that you can accept the public key of the server
      otherwise the crontab entry may not work.

Now configure the client to send the Orca stats files to the server
on the client add the entry to root's crontab ("crontab -e"):

0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/bin/scp -r /usr/local/var/orca/orcallator/ test-server:/usr/local/var/orca/orcallator/
(where vnl-evddb01 is the name of the server in this example which must be resolvable on the client)


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


Final words: I prefer to install gcc3.4.6 and make 3.80, finish compiling and installing everything that requires gcc, then uninstall gcc
and make 3.80. Then install just libgcc3.4.6 (security reasons!)</text>
    <sha1>504983b8488ef839355ade283ff1b17892919c2a</sha1>
  </revision>
  <revision>
    <id>1540</id>
    <parentid>1539</parentid>
    <timestamp>2008-05-22T16:42:17Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>/* == */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7892" xml:space="preserve">This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work)
1. make 3.80
2. gcc 3.4.6
3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc)
4. libiconv-1.11-sol10-sparc-local.gz
5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)
==============================================================
Ayotunde Itayemi (Last updated 22/05/2008)


Installing Apache2 on the Central Server
========================================
make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
You can get all the packages above from sunfreeware.com.


Installing ORCA on server and clients
=====================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)
   Not necessary: Install freetype2 package from sunfreeware

3. set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10)
Also the package SUNWsprot must be installed on the server - it is usually installed by default)
   ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
   http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse
(OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )

6. install Orca (or orcallator.se on clients)
extract the Orca compressed package e.g., to /opt
NOTE: it may be a good idea to install orcallator somewhere else apart
from the default /usr/local since its files will grow e.g., on a dedicated
filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xvf orca-snapshot-r535.tar
cd orca-snapshot-r535

=== Solaris 10 NOTE ==============================================

IN FILE: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

1. change the line "CCCDLFLAGS = -KPIC" to "CCCDLFLAGS ="
2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H

TO:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H


3. change the line "OPTIMIZE = -xO3 -xspace -xildoff" to "OPTIMIZE ="


IN FILE:  orca-snapshot-r535/packages/Storable-2.15/Makefile

1. change the line "CCCDLFLAGS = -KPIC" to "CCCDLFLAGS ="

2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO

TO:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO


3. change the line "OPTIMIZE = -xO3 -xspace -xildoff" to "OPTIMIZE ="


=== END OF Solaris 10 NOTE ==============================


# if you are reinstalling, remember to delete the existing orca folder or else
the new installation will not succeed e.g.,
bash-3.00# rm -rf /usr/local/var/orca

# make fails because the default perl expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# make fails because it couldn't locate perl pod2man executable, so find it and add to PATH
# variable
bash-3.00# find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin


bash-3.00# cd ..
bash-3.00# pwd
orca-0.27b3

bash-3.00#

./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

make; make install; make orcallator_run_at_boot


============ orca doesn't start on solaris 10 ============================

Because the following statement in the orcallator startup script is used
to derive part of the name of the PATH to some of the files needed by
orcalltor, orcallator does not start
"/opt/RICHPse/bin/se -version | awk '{print $4}'"
the reason is that the command above returns 3.4.1 which is the used to
generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
The actual path on the server is /usr/local/lib/SE/3.4
The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1

============ orca doesn't start on solaris 10 ============================


start the orcallator
/etc/init.d/orcallator start


mkdir -p /var/apache2/htdocs/orca/orcallator


DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl


The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

(once it starts up completely without errors and completes the first run,
kill the process (find it's pid with "ps -ef | grep orca")

then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d
for the above process.


edit the /etc/hosts on both the server and client and ensure they can "see" each other
(alternatively use DNS)


Configure the client for "password-less" login to the server
==============================================================
on the client (as root) run "ssh-keygen -t rsa" to generate the client's
authentication key files, when asked for the name of the file
in which to save the key, just press the ENTER key 
and when asked for a paraphrase also press the ENTER key.
Press ENTER key again to confirm the blank paraphrase. 
This generates the default pair of files 
/.ssh/id_rsa and /.ssh/id_rsa.pub

copy the content of the /.ssh/id_rsa.pub from the client into
the /.ssh/authorized_keys on the server.
(make the permission on the authorized_keys file 400 i.w., 
"chmod 400 authorized_keys")

NOTE: the content of the id_rsa.pub file is one single continuous line
NOTE: if there are other lines in the authorized_keys file on the server,
just place the content of the id_rsa.pub file on a new line.
NOTE: extablish a test connection from client to server (at least once)
      manually so that you can accept the public key of the server
      otherwise the crontab entry may not work.

Now configure the client to send the Orca stats files to the server
on the client add the entry to root's crontab ("crontab -e"):

0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/bin/scp -r /usr/local/var/orca/orcallator/ test-server:/usr/local/var/orca/orcallator/
(where vnl-evddb01 is the name of the server in this example which must be resolvable on the client)


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


Final words: I prefer to install gcc3.4.6 and make 3.80, finish compiling and installing everything that requires gcc, then uninstall gcc
and make 3.80. Then install just libgcc3.4.6 (security reasons!)</text>
    <sha1>f6a77f50cecca551cb9747976b090975a45e6760</sha1>
  </revision>
  <revision>
    <id>1541</id>
    <parentid>1540</parentid>
    <timestamp>2008-05-22T16:45:36Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>/* Solaris 10 NOTE =========================================== */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7832" xml:space="preserve">This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work)
1. make 3.80
2. gcc 3.4.6
3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc)
4. libiconv-1.11-sol10-sparc-local.gz
5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)
==============================================================
Ayotunde Itayemi (Last updated 22/05/2008)


Installing Apache2 on the Central Server
========================================
make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
You can get all the packages above from sunfreeware.com.


Installing ORCA on server and clients
=====================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)
   Not necessary: Install freetype2 package from sunfreeware

3. set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10)
Also the package SUNWsprot must be installed on the server - it is usually installed by default)
   ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
   http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse
(OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )

6. install Orca (or orcallator.se on clients)
extract the Orca compressed package e.g., to /opt
NOTE: it may be a good idea to install orcallator somewhere else apart
from the default /usr/local since its files will grow e.g., on a dedicated
filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xvf orca-snapshot-r535.tar
cd orca-snapshot-r535

Solaris 10 NOTE

Edit file: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

1. change the line 
CCCDLFLAGS = -KPIC 
To:
CCCDLFLAGS =

2. change the line 
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =

Edit file: orca-snapshot-r535/packages/Storable-2.15/Makefile

1. change the line
CCCDLFLAGS = -KPIC
To:
CCCDLFLAGS =

2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =

=== END OF Solaris 10 NOTE ==============================


# if you are reinstalling, remember to delete the existing orca folder or else
the new installation will not succeed e.g.,
bash-3.00# rm -rf /usr/local/var/orca

# make fails because the default perl expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# make fails because it couldn't locate perl pod2man executable, so find it and add to PATH
# variable
bash-3.00# find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin


bash-3.00# cd ..
bash-3.00# pwd
orca-0.27b3

bash-3.00#

./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

make; make install; make orcallator_run_at_boot


============ orca doesn't start on solaris 10 ============================

Because the following statement in the orcallator startup script is used
to derive part of the name of the PATH to some of the files needed by
orcalltor, orcallator does not start
"/opt/RICHPse/bin/se -version | awk '{print $4}'"
the reason is that the command above returns 3.4.1 which is the used to
generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
The actual path on the server is /usr/local/lib/SE/3.4
The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1

============ orca doesn't start on solaris 10 ============================


start the orcallator
/etc/init.d/orcallator start


mkdir -p /var/apache2/htdocs/orca/orcallator


DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl


The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

(once it starts up completely without errors and completes the first run,
kill the process (find it's pid with "ps -ef | grep orca")

then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d
for the above process.


edit the /etc/hosts on both the server and client and ensure they can "see" each other
(alternatively use DNS)


Configure the client for "password-less" login to the server
==============================================================
on the client (as root) run "ssh-keygen -t rsa" to generate the client's
authentication key files, when asked for the name of the file
in which to save the key, just press the ENTER key 
and when asked for a paraphrase also press the ENTER key.
Press ENTER key again to confirm the blank paraphrase. 
This generates the default pair of files 
/.ssh/id_rsa and /.ssh/id_rsa.pub

copy the content of the /.ssh/id_rsa.pub from the client into
the /.ssh/authorized_keys on the server.
(make the permission on the authorized_keys file 400 i.w., 
"chmod 400 authorized_keys")

NOTE: the content of the id_rsa.pub file is one single continuous line
NOTE: if there are other lines in the authorized_keys file on the server,
just place the content of the id_rsa.pub file on a new line.
NOTE: extablish a test connection from client to server (at least once)
      manually so that you can accept the public key of the server
      otherwise the crontab entry may not work.

Now configure the client to send the Orca stats files to the server
on the client add the entry to root's crontab ("crontab -e"):

0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/bin/scp -r /usr/local/var/orca/orcallator/ test-server:/usr/local/var/orca/orcallator/
(where vnl-evddb01 is the name of the server in this example which must be resolvable on the client)


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


Final words: I prefer to install gcc3.4.6 and make 3.80, finish compiling and installing everything that requires gcc, then uninstall gcc
and make 3.80. Then install just libgcc3.4.6 (security reasons!)</text>
    <sha1>9cd537c18e4e6fab5f1b7225001de3de0e26adfa</sha1>
  </revision>
  <revision>
    <id>1542</id>
    <parentid>1541</parentid>
    <timestamp>2008-05-22T16:56:34Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>/* END OF Solaris 10 NOTE =========================== */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5694" xml:space="preserve">This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work)
1. make 3.80
2. gcc 3.4.6
3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc)
4. libiconv-1.11-sol10-sparc-local.gz
5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)
==============================================================
Ayotunde Itayemi (Last updated 22/05/2008)


Installing Apache2 on the Central Server
========================================
make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
You can get all the packages above from sunfreeware.com.


Installing ORCA on server and clients
=====================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)
   Not necessary: Install freetype2 package from sunfreeware

3. set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10)
Also the package SUNWsprot must be installed on the server - it is usually installed by default)
   ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
   http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse
(OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )

6. install Orca (or orcallator.se on clients)
extract the Orca compressed package e.g., to /opt
NOTE: it may be a good idea to install orcallator somewhere else apart
from the default /usr/local since its files will grow e.g., on a dedicated
filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xvf orca-snapshot-r535.tar
cd orca-snapshot-r535

Solaris 10 NOTE

Edit file: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

1. change the line 
CCCDLFLAGS = -KPIC 
To:
CCCDLFLAGS =

2. change the line 
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =

Edit file: orca-snapshot-r535/packages/Storable-2.15/Makefile

1. change the line
CCCDLFLAGS = -KPIC
To:
CCCDLFLAGS =

2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =


# if you are reinstalling, remember to delete the existing orca folder or else the new installation will not succeed e.g.,
rm -rf /usr/local/var/orca

# "make" fails when using the default perl installation as it (perl) expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# "make" fails because it couldn't locate perl pod2man executable, so find it and add to PATH variable
find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin

# go back to the extracted installation source folder
pwd
orca-snapshot-r535

# run the configure script
./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

# install orca
make
make install
make orcallator_run_at_boot

# NOTE: orca doesn't start on solaris 10 after the installation process above
# The Reason: the following statement in the orcallator startup script is used
# to derive part of the name of the PATH to some of the files needed by
# orcalltor, orcallator does not start
# "/opt/RICHPse/bin/se -version | awk '{print $4}'"
# the command above returns 3.4.1 which is the used to
# generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
# The actual path on the server is /usr/local/lib/SE/3.4
# The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1


# start the orcallator
/etc/init.d/orcallator start

# this is only needed on the central server
mkdir -p /var/apache2/htdocs/orca/orcallator

# Final words: for security reasons, you may prefer to install gcc 3.4.6 and make 3.80, finish compiling 
# and installing orca and anything else that requires gcc in order to successfully install, then uninstall gcc
# and make 3.80. Finally, install only the libgcc so that does applications that require the library will work properly


# The rest ONLY applies to the central server
#
# DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
# Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
# the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl

# The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

# Once it starts up successfully without errors and completes the first run,
# kill the process (find it's pid with "ps -ef | grep orca")

# then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg

# You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d for the above process.</text>
    <sha1>7dc30d1cbcc1cc5285a1afd0b07af1e6009f3524</sha1>
  </revision>
  <revision>
    <id>1543</id>
    <parentid>1542</parentid>
    <timestamp>2008-05-22T16:57:15Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <comment>/* == */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5546" xml:space="preserve">This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work)
1. make 3.80
2. gcc 3.4.6
3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc)
4. libiconv-1.11-sol10-sparc-local.gz
5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)


========================================
make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
You can get all the packages above from sunfreeware.com.


Installing ORCA on server and clients
=====================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)
   Not necessary: Install freetype2 package from sunfreeware

3. set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10)
Also the package SUNWsprot must be installed on the server - it is usually installed by default)
   ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
   http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse
(OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )

6. install Orca (or orcallator.se on clients)
extract the Orca compressed package e.g., to /opt
NOTE: it may be a good idea to install orcallator somewhere else apart
from the default /usr/local since its files will grow e.g., on a dedicated
filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xvf orca-snapshot-r535.tar
cd orca-snapshot-r535

Solaris 10 NOTE

Edit file: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

1. change the line 
CCCDLFLAGS = -KPIC 
To:
CCCDLFLAGS =

2. change the line 
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =

Edit file: orca-snapshot-r535/packages/Storable-2.15/Makefile

1. change the line
CCCDLFLAGS = -KPIC
To:
CCCDLFLAGS =

2. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO

3. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =


# if you are reinstalling, remember to delete the existing orca folder or else the new installation will not succeed e.g.,
rm -rf /usr/local/var/orca

# "make" fails when using the default perl installation as it (perl) expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# "make" fails because it couldn't locate perl pod2man executable, so find it and add to PATH variable
find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin

# go back to the extracted installation source folder
pwd
orca-snapshot-r535

# run the configure script
./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

# install orca
make
make install
make orcallator_run_at_boot

# NOTE: orca doesn't start on solaris 10 after the installation process above
# The Reason: the following statement in the orcallator startup script is used
# to derive part of the name of the PATH to some of the files needed by
# orcalltor, orcallator does not start
# "/opt/RICHPse/bin/se -version | awk '{print $4}'"
# the command above returns 3.4.1 which is the used to
# generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
# The actual path on the server is /usr/local/lib/SE/3.4
# The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1


# start the orcallator
/etc/init.d/orcallator start

# this is only needed on the central server
mkdir -p /var/apache2/htdocs/orca/orcallator

# Final words: for security reasons, you may prefer to install gcc 3.4.6 and make 3.80, finish compiling 
# and installing orca and anything else that requires gcc in order to successfully install, then uninstall gcc
# and make 3.80. Finally, install only the libgcc so that does applications that require the library will work properly


# The rest ONLY applies to the central server
#
# DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
# Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
# the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl

# The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

# Once it starts up successfully without errors and completes the first run,
# kill the process (find it's pid with "ps -ef | grep orca")

# then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg

# You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d for the above process.</text>
    <sha1>3a944337bc56191b8addb245c5b0fa73ece0e22f</sha1>
  </revision>
  <revision>
    <id>1544</id>
    <parentid>1543</parentid>
    <timestamp>2008-05-22T17:16:26Z</timestamp>
    <contributor>
      <username>Omegax</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5784" xml:space="preserve"># This "How To" is probably just one way to setup the server, but it works.
# The procedure to set up a central repository server or a client on which statistics is to be collected in similar.
# The extra steps to be performed for a server install are indicated where necessary.
#
# All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org were not tested but should also work)
# 1. make 3.80
# 2. gcc 3.4.6
# 3. libgcc 3.4.6 (don't install until you read security comment below)
# 4. libiconv 1.11
# 5. orca-snapshot-r535 (http://www.orcaware.com)
# 6. RICHPse (ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz, http://www.sunfreeware.com/setoolkit.html)
# 
# Quick: if you need to install Apache2 from scratch on the central repository server, here is a list of packages you will likely need:
# make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
# You can get all the packages above from sunfreeware.com.
# 

1. Install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. Use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)

3. Set your PATH and LD_LIBRARY_PATH variables temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. Install libiconv (only if using the GNU gcc from sunfreeware for example)

5. For a server install, the package SUNWsprot must be installed (usually installed by default)

6. Install SE Toolkit (version 3.4 at least for Solaris 10)

gunzip RICHPse.gz
pkgadd -d . RICHPse

Alternatively, if using the RICHPse-3.3.tar.gz package, then use the following commands instead:
gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d RICHPse

7. Install Orca
Extract the Orca compressed package e.g., to /tmp
NOTE: it may be a good idea to install orcallator somewhere else apart from the default /usr/local since its files will grow e.g., on a dedicated filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz
tar -xf orca-snapshot-r535.tar
cd orca-snapshot-r535

# The next 2 steps only applies to Solaris 10

8. Edit file: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

a. change the line 
CCCDLFLAGS = -KPIC 
To:
CCCDLFLAGS =

b. change the line 
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H

c. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =

9. Edit file: orca-snapshot-r535/packages/Storable-2.15/Makefile

a. change the line
CCCDLFLAGS = -KPIC
To:
CCCDLFLAGS =

b. change the line
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO
To:
CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO

c. change the line 
OPTIMIZE = -xO3 -xspace -xildoff
To:
OPTIMIZE =


# if you are reinstalling, remember to delete the existing orca folder or else the new installation will not succeed e.g.,
rm -rf /usr/local/var/orca

# "make" fails when using the default perl installation as it (perl) expects to use the cc compiler, so
# create a soft link to the gcc compiler i.e.,
cd /usr/local/bin
ln -s gcc cc

# "make" fails because it couldn't locate perl pod2man executable, so find it and add to PATH variable
find /usr | grep pod2man
/usr/perl5/5.6.1/bin/pod2man
/usr/perl5/5.6.1/man/man1/pod2man.1
/usr/perl5/5.8.4/bin/pod2man
/usr/perl5/5.8.4/man/man1/pod2man.1

# "perl -v" returns 5.8.4, so use the "second" pod2man above
export PATH=$PATH:/usr/perl5/5.8.4/bin

# go back to the extracted installation source folder
pwd
orca-snapshot-r535

# run the configure script
./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

# install orca
make
make install
make orcallator_run_at_boot

# NOTE: orca doesn't start on solaris 10 after the installation process above
# The Reason: the following statement in the orcallator startup script is used
# to derive part of the name of the PATH to some of the files needed by
# orcalltor, orcallator does not start
# "/opt/RICHPse/bin/se -version | awk '{print $4}'"
# the command above returns 3.4.1 which is the used to
# generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
# The actual path on the server is /usr/local/lib/SE/3.4
# The solution is to create a soft link as below.

cd /usr/local/lib/SE
ln -s 3.4 3.4.1

# start the orcallator
/etc/init.d/orcallator start

# This is only needed on the central server
mkdir -p /var/apache2/htdocs/orca/orcallator

# Final words: for security reasons, you may prefer to install gcc 3.4.6 and make 3.80, finish compiling 
# and installing orca and anything else that requires gcc in order to successfully install, then uninstall gcc
# and make 3.80. Finally, install only the libgcc so that does applications that require the library will work properly


# The rest ONLY applies to the central server
#
# DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
# Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e., 
# the line changes from       #!/usr/bin/perl    TO:     #!/usr/local/bin/perl

# The commands below are ONLY needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

# Once it starts up successfully without errors and completes the first run,
# kill the process (find it's pid with "ps -ef | grep orca")

# then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg

# You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d for the above process.

Ayotunde Itayemi (Last updated 22/05/2008)</text>
    <sha1>4e250e8758c8089b92f0a5bdb50659e7a07b7a61</sha1>
  </revision>
</page>
</mediawiki>